home *** CD-ROM | disk | FTP | other *** search
/ Mac Mania 4 / MacMania 4.toast / / Sound / BarbaBatch 1.72 Demo / BarbaBatch Demo Manual < prev    next >
Text File  |  1995-12-01  |  16KB  |  398 lines

  1. About This Document
  2.  
  3. This document is the manual for the BarbaBatch Demo, it consists of 
  4. three sections of the complete BarbaBatch Manual:
  5.  
  6. What Is BarbaBatch              - Learn quickly what BarbaBatch is
  7. System Requirements           -What do you need to run BarbaBatch
  8.  
  9. BarbaBatch, a quick tour   - Learn quickly about BarbaBatch functions                 
  10.                                                                                                                                                                                                                                             and how to operate them
  11.  
  12. The amount of pictures has been reduced to a minimum in order to minimize download times.
  13. _____________________________________________________________________________
  14.  
  15. What is BarbaBatch?
  16.  
  17. BarbaBatch is a batch soundfile conversion application for the Apple Macintosh.
  18. It is mainly aimed at the production of audio for multi media.
  19.  
  20. One Pass philosophy
  21.  
  22. In BarbaBatch you create a conversion definition yourself by combining format parameters. 
  23. This means there's no need to pass a file  through BarbaBatch several times to achieve a 
  24. complex conversion : everything is done in one pass.
  25. You can even select multiple conversion definitions to convert to different soundfile formats in one pass.
  26.  
  27. Flexible input
  28.  
  29. The input can consist of a mix of all supported soundfile formats : different sample rates, different word sizes, etc.
  30. The input can consist of any combination of soundfiles and soundfile folders with complex structures
  31. which are maintained at the output.
  32.  
  33. Background conversion
  34.  
  35. BarbaBatch runs smoothly in the background, so you can continue working while the conversion progresses.
  36.  
  37. Processing speed
  38.  
  39. BarbaBatch optimizes the processing speed of conversions in one of these ways:
  40.  
  41. - Using a Floating Point Unit (FPU) on 680x0 Macintoshes for calculations.
  42. - Using Digidesign audiocards for calculations.
  43. - Using the PowerPC 60x RISC processor for calculations.
  44.  
  45. Safety first
  46.  
  47. It is not possible to replace existing soundfiles with converted soundfiles.
  48. A log-book file gets created for every conversion run to perform check-ups.
  49. Non-fatal problems occurring during the conversion process are both displayed in 
  50. a status window and logged in the log-book file..
  51.  
  52. _____________________________________________________________________________
  53.  
  54. System requirements
  55.  
  56. BarbaBatch runs on Apple Macintosh platforms only.
  57.  
  58. BarbaBatch will run on any 68 K Mac with an FPU (Floating Point Unit) installed.
  59. To check whether your Mac has one installed, please refer to your technical reference manual, consult your Mac dealer, or launch the BarbaBatch Demo.
  60. Also BarbaBatch is PowerPC Native, so it will run accelerated on PowerPC's.
  61.  
  62. Digidesign hardware
  63.  
  64. Digidesign soundcards may be used to increase the processing speed on 680x0 Mac's. 
  65. (BarbaBatch doesn't use Digidesign soundcards on Powermac's, but uses the internal RISC processor instead)
  66. The following Digidesign hardware may be used:
  67. SoundTools I, II
  68. AudioMedia I, II,LC
  69. ProTools II
  70.  
  71. Digidesign software
  72.  
  73. In order to use Digidesign hardware, you need the DigiSystem INIT that came with your hardware. 
  74.  
  75. PowerPC
  76.  
  77. BarbaBatch is accelerated for PowerMac.
  78. Digidesign hardware on PowerMac's is not supported, since the powermacs RISC processor is fast enough by itself
  79.  
  80. Disk space
  81.  
  82. A lot of harddisk space is recommended since digital audio takes up a lot of space.
  83. For safety reasons you are not able to replace soundfiles with converted soundfiles.
  84. When converting samplerate and gain at the same time without using Digidesign hardware, temporary files are created on the harddisk. All this adds up if you convert large soundfiles.
  85.  
  86.  
  87. System Software
  88.  
  89. BarbaBatch runs on Macintosh System Software 7.1 or later.
  90.  
  91.  
  92. SoftFPU
  93.  
  94. The software FPU emulator SoftFPU may be used for Macintoshes without a floating point processor, allthough this is not recommended. It will make BarbaBatch run very slow in processes like normalising and samplerate conversion, when no DigiDesign hardware is used to aid in the calculation.
  95.  
  96.  
  97. _____________________________________________________________________________
  98.  
  99. BarbaBatch, A Quick Tour
  100.  
  101. Launch BarbaBatch. 
  102. An introductory window will appear while BarbaBatch starts up. 
  103. After 7 seconds or after clicking in it, it is replaced by the main window of BarbaBatch.
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. In the top row there are four large buttons that cover four steps.
  131. From left to right these buttons mean:
  132.  
  133.  
  134. 1 Selecting the files and folders you want to convert
  135.  
  136. 2 Selecting the desired conversion(s)
  137.  
  138. 3 Selecting a destination where the converted soundfiles will be stored
  139.  
  140. 4 Starting the conversion process.
  141.  
  142.  
  143. We will now take a look at the functionality behind these four buttons.
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152. 1.    The Input button
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.                 Selecting the files and folders you want to convert
  161.  
  162. When you press the 'Input' button, the Input dialog appears.
  163. The Input dialog consists of a scrolling list of all your input files and folders, an Add button, a Remove button and a Remove All button.
  164.  
  165. When you press the 'Add' button, the 'Add file or  folder' dialog appears. You can navigate to the files and folders you want to convert and press the 'Add' button every time you want to add one to the list. Added items appear immediately in the input list of the Input dialog.
  166.  
  167. The input batch, as we call it, can consist of any file type known to BarbaBatch at the same time.
  168. BarbaBatch can convert from and to any of the following formats:
  169.  
  170. Sound Designer I - Digidesigns first, one channel file format
  171. Sound Designer II - current Digidesign file format
  172. AIFF - Audio Interchange File Format (it also reads Sonic Solutions AIFF Files)
  173. WAV - Microsoft Windows standard sound file format (.WAV)
  174. VOC - standard 8 bit Creative Voice sound file format mostly used for MS-DOS (.VOC)
  175. VOC16bits -  extended VOC file for 16 bits and high sample rates  (SoundBlasterPro)
  176. NeXT/SUN.snd - The linear PCM version of the native NeXT and SUN audio format
  177. NeXT/SUN.au - The 8 bit µ-law  version of the native NeXT and SUN audio format
  178. Amiga IFF/8SVX - A  popular Commodore Amiga sound file format
  179. AVR - originally an Atari format
  180.  
  181. On top of that BarbaBatch  can convert to  QuickTime movies' sound file format.
  182.  
  183. When a sound file is highlighted in the 'Add file or  folder' dialog, you can view its properties (file type, sample rate, word length and file length) in the text below.
  184. When a folder is highlighted in the 'Add file or folder' dialog, you can press the Examine button to view the contents of the folder. (All its enclosed folders are also examined). BarbaBatch then shows a list similar to the following:
  185.  
  186. Folder consists of:
  187. 112 AIFF Files
  188. 80   Sounddesigner II Files
  189. 43   NeXT/Sun mulaw (.au) files
  190. 20   files of unknown type.
  191.  
  192. If there are more than four different file types in the folder BarbaBatch shows something like:
  193.  
  194. Folder consists of:
  195. 620 files of various types.
  196.  
  197. When you have added all the files and folders you want to convert, press the 'Done' button.
  198. You return to the main dialog. Here you can remove an item from your input list by selecting that item and pressing the Remove button. You can also remove all items pressing the 'Remove All' button.
  199.  
  200. There is another way to build your input batch: go to the finder and simply drag the items to the BarbaBatch application icon. When the BarbaBatch icon highlights drop them.
  201.  
  202. When you are satisfied with your input list, it is time for step two.
  203.  
  204.  
  205.  
  206. 2.    The Conversion button
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.                 Building and selecting conversions
  214.  
  215.  
  216.  
  217.  
  218. When you press the 'Conversion' button, a scrollable list of conversions you have already built appears.  When you never defined a conversion before, the list is empty.
  219.  
  220. Suppose you want to convert the input batch to the following format:
  221.  
  222. WAV files, 
  223. 8 bits, 
  224. 22050 Hz sampling rate, 
  225. normalised to a ceiling of -2 dB.
  226.  
  227. You have to build a conversion that meets these requirements. Push the New button in the conversion dialog. A dialog called 'Define New Conversion' appears.
  228.  
  229. In the name field you enter the name of a conversion. Call it 'WAV,22050 Hz,8 bits'.
  230. This name will appear in the conversion list when you are finished building the conversion.
  231.  
  232. Select all the desired properties: Wave, 22050, 8bits, -2db and leave the rest of the check boxes open.
  233.  
  234. Your window should look like this:
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                                   The fields of the 'Define New Conversion' dialog
  269.  
  270. When you are done editing your conversion, press the 'Add' button to add it to the list.
  271.  
  272. The 'Define New Conversion' dialog disappears and you return to the conversion dialog.
  273.  
  274. BarbaBatch automatically  'checks' the conversion you have just created in order to actually perform it when you eventually run the process. You can toggle a check on or off by clicking in front of the conversion name in the conversion list. When you check multiple conversions, BarbaBatch will perform them one after the other in one pass.
  275.  
  276. If you have the proper Digidesign hardware (see System Requirements) you can use it to speed up the sample rate conversion and normalising process considerably. Select the board you want to use in the rightmost popup in the conversion list window.
  277. This is not possible in the native PPC version since the PPC 's risc processor is quite fast on its own.
  278.  
  279. Even if you do have a Digidesign card, you can choose to run BarbaBatch in the background without using the card. In this way, you will be able to use your Digidesign hardware for editing, playing and recording in the foreground, while BarbaBatch is processing in the background. Do this by selecting the option Don't use a card in the popup of the conversion dialog.
  280.  
  281.  
  282. It is very important to realise that you do not have to check every conversion parameter. When you do not check a parameter,it will be copied from the inputfile.
  283. You can for instance choose not to alter the file type, word length etc. while normalising the complete input batch. The output files will have all the original properties of the input files except for their gains.
  284.  
  285. Another important thing to realise is that there can be incompatibilities between your input files and your conversion definition.
  286. For example, suppose you choose not to alter the file type of your input files by not checking the 'convert file type to…' option, but you have checked 'change sample rate to 48000 Hz'. Obviously when a VOC file, having a maximum sample rate of 20000 Hz, comes in at the input it cannot be converted, because BarbaBatch will atempt to create a 48kHz VOC. When such an incompatibility occurs, the file will not be converted and the event will be reported in the log discussed hereafter.
  287.  
  288.  
  289.  
  290.  
  291. 2.1  The fields of the 'Define New Conversion' dialog
  292.  
  293. Since this is a 'Quick Tour' the various fields in the 'Define New Conversion' dialog will only be discussed very briefly.
  294.  
  295. The fields of the 'Define New Conversion' dialog
  296. Convert file type to ...
  297. Here you select the file type of your output files. The possibilities are listed in the section explaining the Input button.
  298.  
  299. Convert sample rate to…
  300. Here you select the sample rate of your output files. Sample rates must be lower than 100 kHz.
  301.  
  302. If no card available, use quality…
  303. If there is no Digidesign hardware available to assist in the sample rate conversion process, or you don't want to use it, the Mac will have to do it on its own. There are two quality (speed) choices for this scenario: Linear (fast) and Polyphase (slower).
  304. If you select a Digidesign card in the popup menu of the conversion dialog, this field is ignored, and the Polyphase method will be chosen.
  305.  
  306. Convert number of bits to…
  307. Here you can select the word length of your output files. Choices are 16 bits and 8 bits.
  308.  
  309. Change maximum level to…
  310. If you check this option, your output files will individually be normalised to the ceiling that you enter.
  311.  
  312. Change # of channels
  313. When checked, the input files' channels will be converted to the output files' channels using the scheme selected in the associated popup dialog.
  314. This setting has no effect on nput files with more than two channels, they will be converted automatically to output files with the same amount of channels. 
  315.  
  316. Process regions by…
  317. Sounddesigner II files and Wave files can contain regions: named selections of audio.
  318. The choices here are:
  319.  
  320.      Extract : every region from every input file will be converted to a separate file,
  321.      bearing the name of  the original region. These regions will be stored in a folder 
  322.      bearing the name of the 'parent file'.
  323.      Of course other conversion parameters will also affect the extracted audio files.
  324.  
  325.      Compact : the audio in the input files that is not enclosed by regions is not converted, 
  326.      hence, your output files will normally  be shorter than your input files.
  327.  
  328. Use fade-time/safety margin of…
  329. Depending on which of the region processing schemes you select , you need to set either a fade-in/out time or a safety margin.
  330.  
  331. In the case of Extract you will need to set a Fade-in/out Time. BarbaBatch will create a linear fade-in and -out within every region of the desired time. This is generally used as an impact softener or an anti DC-click fade. Set it to zero if you do not want to fade at all.
  332.  
  333. In the case of Compact you will need to set a safety margin. This is an amount of time added before and after every region before it is converted in the stripping process. Usually this is used as a safety margin for future cross-fading.
  334.  
  335. Use Dither
  336. If you check this option, dither will be used everywhere this would be necessary.
  337. The manual will go into great detail as to when, where and how will be dithered.
  338.  
  339.  
  340. Copy markers, regions & loops
  341. If you check this option, markers loops and region definitions will be copied to the output file whenever it is possible. (For example VOC files have no ability for region definitions, hence, regions can not be copied to VOC files.) 
  342. The timing of markers, loops and region definitions are corrected after sample rate conversion, extraction and compacting.
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350. 3     The Output button
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.                 Selecting a destination for the conversion output
  359.  
  360. None of the conversions is performed 'in place'. All the original files will stay on the disk unaltered. This means that you have to select a folder to store the result of the conversions. You do this by pressing the third button: 'Output'.
  361.  
  362. Here you can view the destination folder and the volume it is on, along with the free space on that volume. When you enter this window for the first time nothing is selected.
  363.  
  364. Press the 'Destination Folder:' button.
  365. A 'Select Folder' dialog appears. Navigate to the desired destination folder or create a new one by pressing the button 'New Folder'.
  366. When you finally select a folder, the window disappears and you return to the 'output' window.
  367.  
  368. In the output folder BarbaBatch will create a new folder, bearing the name of the conversion checked. If there are multiple conversions, multiple folders will be created on this level. The complete folder hierarchy of the input batch is copied to every conversion folder.
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377. 4    The Start button
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.                 Starting the conversion process
  385.  
  386. When an input batch is created, one or more conversions are checked and an output folder has been selected, the fourth button becomes active: the 'Start' button.
  387.  
  388. By pressing it you set BarbaBatch in motion. The main dialog disappears and is replaced by the status dialog, which will keep you updated during the conversions.
  389.  
  390. Along with that, a detailed log-book textfile of the conversion will be created in the output folder.
  391. In this log-book, information about the conversion specification along with the names of the soundfiles converted is listed. If an error occurs you can read it in the status dialog and in the log file.
  392.  
  393. The logbook is a text file that can be opened using the menu items 'Show Log...' or 'Show Last Log' in the File Menu. You can also use any text processor to open the textfile. You can find the reason for any error occured by looking up the error message in the appendix Error Messages.
  394.  
  395.  
  396. __________________________________________________________________________
  397.  
  398. SoundDesigner I, SoundDesigner II,Audiomedia I, II & LC, SoundTools I & II, ProTools II, Sonic Solutions, Windows, Creative Voice, SoundBlasterPro, NeXT, SUN, Amiga, Macintosh, are trademarks or registered trademarks of the respective product's manufacturer.